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I. Introduction 

The CNTOUR program plots an intensity relief map of an image which 
is read from tape, disc, or from either vidisector camera. It is used to 
examine vidisector images. It may also be used as a general purpose 
aiming, monitering, and focusing program, especially for high-contrast 
images, for which it produces something like a line drawing. The program 
is available both in a time sharing and a non time sharing version. 



II. Operating Instruction Summary 

This section gives step- by-step operating instructions for the 
program. It should be sufficient for most purposes. Ibr more detailed 
instructions, read section III of this memo. 

1. lead in the program. An up to date copy of the time sharing version 
will always be kept on tape IMAGE 2, in the drawer labeled KRAKATJER. It 
will be found filed under the name CKTOUH nBMP, where n is the latest 
version number (currently 21). As of this writing, the non TS version has 
not been run in many months. Hirn on the vidisector power and 2 or 5 
sunguns, and, for the old vidisector, turn off the fluorescent room lights 
to reduce noise. Set the vidisector focus to approximately the correst 
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distance, and adjust the lens aperture. R>r the old vidisector, set the 
vidisector switch to the '7=40" position and set the mode switch to either 
dim" or "brite" mode. The brite mode is in general useful only for 
bright, high contrast otjects against a dark background. 

2. Start the program by typing G0$G. ($=ALT. MODE). Select the 
vidisector desired by typing 0< for the new vidisector (TV-C) or -1< for 
the old vidisector (TV-B). The new videsector is initially selected. 
Steps 3 and 4 may be skipped, but will very probably result in better 
contours. 

3. Type an H to obtain a histogram. In TS, the program will type 
DISPLAY BUSY if it is. 

4. Type |E (CONTROL E) . 

5. Type C to plot the contours, when this processing is completed, an * 
is typed. To turn on the display, type D. To turn it off, type K, and to 
de-assign it, type I N. 

6. To see the contours one at a time, type IP, then or B repeatedly. 
To see them all at once, type :P. To write out what is being displayed, 
turn on the CALCOMP plotter, and type w. 

Repeat steps 3-6 for further images. 
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III. Operating Instructions 

5br the purposes of this discussion, a "contour", at a given 
"threshold" (or "level"), is a set of closed curves enclosing all those 
points in an image whose intensity is greater than the specified 
threshold. Itote that these contours correspond to the contours of a 
relief map, and not the boundaries of an object, as the word is sometimes 
used in the vision group. If the image were continuous, the contour at a 
given threshold would simply be the locus of all points whose intensity 
was equal to that threshold, but since the vidisector image is sampled 
rather than continuous, this definition does not quite fit. The program 
assumes all points outside of the image area to be black, and thus to be 
below the threshold. CNTOUR produces a set of contours at specified 
thresholds, which may be displayed separately or superimposed upon one 
another to produce a complete intensity relief map. 

The program was designed for studying images as the vidisector 
sees them. In cases where the image has a very high contrast, as when it 
consists of white objects on a black field, the contour lines at several 
thresholds will fall on the boundaries of the objects, just as contour 
lines on a relief map come together on an abrupt change of altitude, such 
as a cliff. The result will appear to be an outline drawing of the 
objects. The objects may thus be quickly recognized, and so the program 
may be used as a monitor program, and for aiming the camera. It may also 
be used for focusing the camera, ty observing the closeness of the contour 
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lines at a high contrast edge. In the case of images with less contrast, 
the objects may "be harder to recognize, and the contour map thus harder to 
interpret. 

The different sections of the program may he run in almost any 
order, under typewriter control. Control is by single letter commands, 
preceeded "by zero, one, or two numerical arguments. If there are two 
arguments, they are separated by a comma. timbers are taken to he octal, 
unless they are followed ty a decimal point. The character : (colon) is 
taken as a number, and has the value -1. 

When using the old vidisector, typing a | F causes transfer to a 
focus routine. Vidisector readings are taken along a short horizontal 
line, whose position is indicated Toy a letter H (for "Read 1 *) displayed on 
the scope. A plot of the values read is also shown. The position of the 
line and density of the points can he adjusted from the small pot box. 

The user must begin my supplying a list of thresholds at which he 
wants contours plotted. This list may contain up to 36 entries, numbered 
1 through 36. A number k specifies the total number of contours to be 
plotted, so that a contour will be plotted for list entry 1 thru list 
entry k. Entries may be inserted into the list by typing the command n,mL 
(Jpad), which will insert the threshold m into list entry n. Jtirthermore, 
it will update k to take in the list entry just inserted; that is, 
k'=max(n,k). k may also be set directly by the command nK, The command 
mL is equivalent to k+l,mL. 



CNTOUR 5 



„„„ thresholds into the tahle manually is somewhat cu-herso.e, 
however, especially since .11 one generally wants to do is to display 
contours for a series of evenly spaced thresholds hetween an upp« and a 
Xover hound, ftis may he done usite the nE command (arter threshold 
tahle). This command actually has three arguments, one typed, and the 
other two coming fro* the left and right halves of the console switches. 
K is set to n, and n threshold values are inserted into the threshold 
tahle, the iowest heins approximately the value found in the left ha!f of 
the switches, and the highest hei,* the value in the right half of the 
switches, with n-2 values evenly spaced in hetween. tte actual values 
used are Him/MH, (0 ± i i n-l> , where L and R represent the 
m hers in the left and the right Lives of the switches respectively, and 
the conations are done in integer arithmetic. If the command 1 is used 
.ithout an ardent, the ardent is taken to he the tot non-zero 
argument used in front of an E. 

In order to he ahle to know where to insert the thresholds, a 
histogram of light intensities »ay he plotted, * typing the command H 
(Sstogtfcm). The result will he a graph whose *-asts is mi»s the log of 
the values read fro. the vidlsector, and whose y-axls gives the numler of 
points in the i«age for which that particular value was read. »te that 
hlrt er numbers indicate brighter points, so Uat on the x-axis, hrightness 
increases to the right. The -i.her of ti.es the value was read is not 
shown on the histogram, since this value corresponds to all those pulnts 
which were too dark for the vidlsector to detect, and is often a very 
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high number. The scale of the y-axis is indicated by a short horizontal 
line just to the right of the graph, which is at a height of 10 (decimal) 
units. Just to the right of this line is a two digit number indicating, 
the percentage of points above the dark cutoff. TVo vertical lines 
indicate the values in the left and right halves of the switches. Thus, 
one can pick out the intensity region of interest on the histogram, 
bracket it with the two vertical lines by setting the testword switches, 
and do an nE operation to generate the table of thresholds. 

The command |H plots a histogram just as Hdoes, except the values 
are taken from a picture in the memory, rather than from the vidisector. 
In order to use |H, a picture must have been previously read by the C or 
|C commands (see below). 

The command |E is the same as E, except that the upper and lower 
bounds are not taken from the testword switches, ffather, the highest and 
lowest values obtained in the last histogram are used. H or iHmust be 
run before |E. 

The command C (Contours) will now result in the reading of an 
image from the vidisector, and the level- by- level processing of it to 
trace the contours. An * will be typed when the processing is complete. 
The image is read into an image buffer, and the processing, generates 
increment commands which are packed into a display buffer, from which they 
are fed to the display. The contours may be displayed singly, or all at 
once, or in any other combination, under the control of a mask register. 
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A 1 in bit 36-i of the mask register causes display of the ith contour. 
Hunters may be inserted into the mask register by the command nP (Rit into 
mask register). Thus, a "IP" causes display of the first contour, a "2P" 
causes display of the second contour, a "4P" causes display of the third 
contour, and a ♦VP" causes display of the first three contours together. 
The command :P causes display of all the contours. When a contour is 
displayed, the value of the threshold for that contour is also displayed 
in the array at the top of the screen, in a position corresponding to the 
position of its bit in the mask register. There is no need to elaborate 
much more about this system, as one gets the hang of it quickly after a 
few moments of use. Other commands affecting the mask register are: nl 
(IOR), inclusive OR n to the mask register; nF (ojf ) , ANDCA n to the mask 
register, and (Qnward)and B ( Jickward) , rotate the mask register once 
left or once right, respectively. 

The command n|Cnl n2(car. ret.) causes a picture to be read from 
tape n, file names nl n2, instead of directly from the vidisector. If n 
is less than or equal to 0, disk In I is specified. If an error is made 
while typing the file names, type rubout and restart the file names. If 
the argument n is omitted, the last tape used will be assumed. Similarly, 
if a carriage return is typed immediatly after the |C, the last file names 
typed are used. The contours are then plotted as for the C command. 

At this stage, one may wish to reset the thresholds, and reprocess 
the same image. The image may be reprocessed, without reading a new 
image, by typing the command A (Again). Any operation such as a histogram 
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display, for example, may be halted at any time ty typing a J (Jxmp out), 
and the display may be resumed by typing a D (j&splay). 

The display may be turned off at any time by typing an N (J) 
display) and on again by typing a D. If the display is off, typing an S 
(Single display) will display the contents of the display Ixiffer 20 
(octal) times, and then turn off the display again. This feature, 
currently available in the non-time sharing version only, is used for 
photographing the display by setting the camera on time or bulb. It will 
always result in uniform exposures, regardless of the length of the 
display buffer. Br the way, nS, where n is not 0, will display the 
contents of the buffer n times, ibr hard copy, the command W (Write) will 
write the contours out on the CALCOMP plotter. The contours which are 
being displayed at the time will be written, so that contours may be 
written, as they may be displayed, singly or in groups. The command nW 
will enlarge the drawing by a factor of n. 

When the image is read from a vidisector, the vidisector must be 
first selected by typing the command n<, where n is -1 or 0. -1 specifies 
the old vidisector (TV-B), the new (TV-C). 

The location of the image read is given ty four numbers, set by 
four commands. nX and nY set the x and y coordinates of the lower 
left-hand point of the rectangular area to be read, and nlXand n|Y set 
the coordinates of the upper right-hand corner. nR sets the courseness of 
the scan; that is, the number of units between points. These numbers are 
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taken as "being in the coordinates of the vidisector currently selected. 

The command nU adds n to both the lower and the upper x 
coordinates, and nV does the same for the y coordinates. This allows a 
shifting of the picture region without a change in its area. 

Typing a Q (&iery) causes two vertical and two horizontal lines to 
appear, the intersection of which indicates the area specified by X, Y, 
|X, |Y, and R, projected onto the contours already being displayed. B^ 
watching these lines as these numbers are varied, a region of the area 
under display may he selected for finer inspection. The lines may "be 
turned off by typing another Q. 

Taping |D causes a description of the image on the tape last read 
to be typed out. The high and low x and y points and the x and y 
densities are given in both old and new vidisector coordinates. 

The contour tracing routines normally suppress contours whose 
perimeter is below a certain length, to supress contours caused by noise. 
This length is ini tally set at 20 (octal), but may be changed by typing nG 
(Gronk all contours less than n). The command G alone (or 0G) will result 
in the display of all contours present, but this is not advised, as there 
are normally a large number of very small contours present which are 
caused solely by vidisector noise. 

In the non-time sharing version, typing an M returns control to 
Macdump, and typing a T sends control to ddT. In the TS version, typing a 
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form feed causes a form feed to be typed hack in order to clear the screen 
on the GE consoles. 



V. Alphabetical Command list 



Com. Mnemonic 



Operation 



Again 



Be trace contours without reading a new 
image. 



B Backwards 



Contours 



nlCnl n2 Contours 



Display the previous contour (i.e. rotate 
the mask right). 



Bead an image and trace the contours. 



Bead an image from tape and trace the 
contours • 



Display 



TUrn on the display. 



|D Describe 



Describe the picture on tape or disc which 
was last read. 



nE Enter 



Bead an upper and lower bound from the 
switches and enter n thresholds between 
them. 



4b^r *&&■•<&& ***&* ^dSySS**®***** 
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nil Eater 



Enter n thresholds between the highest and 
lowest values read. 



nF of? 



T&rn off the contours indicated ly n 



| ? R>cus 



Transfer to focus routine. 



nG Gronk 



Eliminate contours smaller than n. 



H Histogram 



Plot a histogram from the vidisector. 



t'H Histogram 



Plot a histogram from the image in core, 



nl IOR 



TUrn on the contours indicated ly n. 



Jimp out 



Interrupt whatever doing and go to wait 
state* 



nK k 



Enter k f the numher of contours to he 
plotted from the tahle. 



n,ml load 



load the value m as contour threshold mmher 

n. 



Macdmp 



Go to MACBMP (non TS only), 



N » display 



flush display (TS only) 



$t&**m 
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|N K> display 



Turn off the display 



Onward 



Display the next contour (i.e. rotate the 
mask left). 



nP Put 



Display contours according to n. 



Qaery 



Turn on (or off) lines showing position of 
next image to be read. 



nR Ifester 



Set the raster spacing to n. 



Single display 



Display briefly for photography (non TS 
only) 



ddT 



Go to DDT (non TS only). 



nU 



Add n to lower and upper x limits. 



nV 



Add n to lower and upper y limits. 



nW Write 



Plot contours on CA1COMP plotter, magnified 
by n. 



n|Wnl n2 Write 



Write out image as file nl n2 on tape n. 



nX x 



Set lower x limit to n. 



rv 
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